German Manual below / Deutsches Handbuch weiter unten...			Version: 2018.08.15


LambdaSpeak Speech Synthesizer:
===============================
More about this great piece of hardware can be found here:
https://github.com/lambdamikel/LambdaSpeak

This is a new generation speech synthesizer which emulates/simulates the following expansions:
- dk'tronics SPEECH synthesizer
- Amstrad SSA1 synthesizer
- Amdrum drum kit
Furthermore the LambdaSpeak provides two more extended modes (Epson Mode, dectalk mode), in this new
modes the expansion can use different voices and it can even sing!


SUPPORT the development of this RSX command exentsion and ROM
======= -----------------------------------------------------
Support via PayPal: tfm@futureos.de



 ENGLISH
-=======-

RSX Library for the LamdaSpeak expansion card
---------------------------------------------
Put disc in drive and type:

run"disc

Or you can use the "LS.ROM" as an expansion ROM containing all RSX commands and more.
Before you use the LambdaSpeak ROM you should use the RSX command |LSINIT to setup LambdaSpeak.

When using the RSX commands |SPEAKSCREEN or |SPEAKFILE you have to enter 'blocking mode' before.
Use the RSX command |BLOCKON to switch 'blocking mode' active.


List of Commands
================

The RSX command |LSHELP will display this list on screen:

RSX commands for LambdaSpeak:
|LSINIT / |LSINIC --> Use this command to initialize LambdaSpeak after reset!
|RESET             |STOP             |SP,@text$      |LAMBDASPEAK,@text$
|SETVOLUME,0-15    |GETVOLUME,@v%    |SETVOICE,0-15  |GETVOICE,@v%
|SETSPEED,0-15     |GETSPEED,@v%     |SETDELAY,0-15  |GETDELAY,@v%
|SPEAKMODE         |GETLANGUAGE,@v%  |ENGLISH        |SPANISH
|LAMBDA            |SSA1             |DECTALK        |DKTRONICS
|SSASPO            |DKSPO            >Version:       >2018.08.15
|GETMODE,@v%       |GETVERSION,@v%   |BLOCKOFF       |BLOCKON
|CONFOFF           |CONFON           |GETFAST        |GETSLOW
|SPEAKINFO         |SPEAKSCREEN      |SPEAKFILE      |DAISY
|HAL9000           |AMDRUM           |PCMTEST
|PLAY,adr,len,del  |EPLAY,address,length/64,delay,E-RAM
|LSHELP --> will display this message. Support via PayPal: tfm@futureos.de


Commands to control LambdaSpeak:
--------------------------------

|LSINIT: Initializes the LambdaSpeak when using the LambdaSpeak ROMs. The following steps are carried out: The passing
of paramerts is switched to 'fast' (using |GETFAST), the language is set to English (|ENGLISH), the Blocking is set to
OFF (|BLOCKOFF), the mode is set to Epson (|LAMBDA) and the speech delay is set to a minimum (20 ms) (|SETDELAY,1).

|LSINIC: Initializes the LambdaSpeak when using the LambdaSpeak ROMs. The following steps are carried out: The passing
of paramerts is switched to 'fast' (using |GETFAST), the language is set to Spanish (|SPANISH), the Blocking is set to
OFF (|BLOCKOFF), the mode is set to Epson (|LAMBDA) and the speech delay is set to a minimum (20 ms) (|SETDELAY,1).

|RESET: This equals about to switch OFF and ON the LambdaSpeak. Switches LambdaSpeak into the dk'tronics mode.

|STOP: Stops the current output of language (in non blocking mode).


Commands to select the LambdaSpeak mode:
----------------------------------------

|LAMBDA: Selects the powerful native Epson mode.

|DECTALK: Selects the DECtalk mode, it even can sing songs.

|DKTRONICS: Switches to the dk'tronics mode. The LambdaSpeak now emulates the dk'tronics SPEECH module.

|SSA1: Switches to the Amstrad SSA-1 mode. The LambdaSpeak now emulates the Amstrad SSA-1 speech synthesizer.

|SSASPO: Switches to the SSA1 SPO256-AL2 mode.

|DKSPO: Switches to the dk'tronics SPO256-AL2 mode.

|AMDRUM: Switches to the Amdrum mode. The LambdaSpeak now emulates the AMDRUM drum system.
         This mode needs to be activated when using the RSX commands |PLAY and |EPLAY to play samples.
         Attention: There is NO WAY BACK. This mode can only be left by switching the LambdaSpeak OFF and ON!


Commands to select parameters of the LambdaSpeak expansion
----------------------------------------------------------

|SETVOLUME,0-15: Sets the volume to a value between 1 and 15. The value 0 select the standard volume.

|SETVOICE,0-15: Sets the voice to a value between 1 and 15. The value 0 select the standard voice.

|SETSPEED,0-15: Sets the speed of speaking to a value between 1 and 15. The value 0 select the standard speaking speed.

|SETDELAY,0-15: Sets the delay to a value between 1 and 15. The value 0 select the standard delay.
                With the 'delay' the time is indicated, which will pass before the LS starts talking after 
                sending the last character to it.

|ENGLISH: Switches the language to English.

|SPANISH: Switches the language to Spanish.

|BLOCKON and |BLOCKOFF: These two commands switch the 'Blocking' on and off. If the 'Blocking' is switched on, then the 
                        LambdaSpeak will WAIT the CPC until all characters are spoken and the LambdaSpeak is ready again.

|CONFON and |CONFOFF: These two commands switch the 'Conformations' on and off. If the 'Conformations' are switche on,
                      the LambdaSpeak will tell you all alterations (f.e. mode, language etc.) acusticly.

|GETFAST and |GETSLOW: Both commands influence the speed of reaction of the LambdaSpeak when passing parameters.
                       When using machine language the 'fast' mode should be used. Thats also true for RSX commands.
                       When using BASIC programs (with you own OUT commands) the mode should be switched to 'slow'.


Befehle zum Auslesen bzw. Einstellen der Parameter des LambdaSpeak
------------------------------------------------------------------

|GETVOLUME,@v%: Reads the actual value of 'volume' (from 1 to 15) into a variable.
                This variable (here: v%) must be defined before usage.

|GETVOICE,@v%: Reads the actual number of the used 'voice' (from 1 to 15) into a variable.
               This variable (here: v%) must be defined before usage.

|GETSPEED,@v%: Reads the actual value of 'speed of speech' (from 1 to 15) into a variable.
               This variable (here: v%) must be defined before usage.

|GETDELAY,@v%: Reads the actual value of 'delay until speech' (from 1 to 15) into a variable.
               This variable (here: v%) must be defined before usage.

|GETLANGUAGE,@v%: Reads the actual value of 'used language' (from 1 to 15) into a variable.
                  This variable (here: v%) must be defined before usage.

|GETMODE,@v%: Reads the actual value of 'speech mode' (from 1 to 15) into a variable. Depends on mode, language, blocking.
              This variable (here: v%) must be defined before usage.

|GETVERSION,@v%: Reads the actual value of 'version of LambdaSpeak' (from 1 to 15) into a variable.
                 This variable (here: v%) must be defined before usage.

|SPEAKMODE: The LambdaSpeak tells its actual speech mode.


Commands to output speech
-------------------------

|SP,@text$ or |LAMBDASPEAK,@text$: The words contained in the variable text$ will be spoken using LambdaSpeak.

|SPEAKSCREEN: The actual content of the screen will be spoken using LambdaSpeak.
              ATTENTION: The command |BLOCKON must be used before this command to switch on 'Blocking'.
              ---------- This command can be cancelled by pressing the ESCape key for some seconds.

|SPEAKFILE,file$: The content of an ASCII file (here: 'file$') will be spoken using LambdaSpeak.
                  ATTENTION: The command |BLOCKON must be used before this command to switch on 'Blocking'.
                  ---------- This command can be cancelled by pressing the ESCape key for some seconds.


Specific commands
-----------------

|SPEAKINFO: Provides (tells) information about the LambdaSpeak speech synthesizer.

|DAISY: Just sings a song.

|HAL9000: Tells a citation from the legendary HAL9000 computer.

|PCMTEST: Send an 'test sample' to the Digital-Analog-Converter of the Amdrum emulation. Will loop forever.


Commando for the Amdrum Mode of the LambdaSpeak
-----------------------------------------------

|PLAY,adr,len,del: Plays a sample using the Amdrum emulation. The sample begins at address 'adr' in main RAM,
                   it's 'len' bytes long and will be played with a delay of 'del'.
                   Attention: Before using this command you need to switch Amdrum emulation on using |AMDRUM.
                   ---------- From the Amdrum mode you can only switch back using a power cycle.

|EPLAY,adr,len/64,delay,E-RAM: Plays a sample using the Amdrum emulation. The sample begins at address 'adr' in 
                               the expansion RAM, it's 'len/64' bytes long and will be played with a delay of 'del'.
                               The length in bytes can be calculated by: len * 64
                               This way you can play samples up to 4096 KB.
                               The expansion RAM in which the sample starts is provided in variable 'E-RAM'.
                               The parameter 'E-RAM' has the format of &7FC4, &7FC5, ... &7FFF.
                               Attention: Before using this command you need to switch Amdrum emulation on using |AMDRUM.
                               ---------- From the Amdrum mode you can only switch back using a power cycle.

Attention: Samples located in the first 64 KB of RAM are played using |PLAY, whereas sample being located in the
---------- expansion RAM will be played using the command |EPLAY



 DEUTSCH
-=======-

RSX Bibliothek fr die LambdaSpeak-Erweiterungskarte
----------------------------------------------------
Legen Sie die Diskette ins Laufwerk und tippen Sie:

run"disc

Oder Sie knnen die Datei "LS.ROM" als Erweiterungs-ROM einbinden, es bietet alles RSX Befehle und mehr
Bevor Sie das LambdaSpeak ROM nutzen sollten Sie LambdaSpeak mittels des RSX Befehls |LSINIT aufsetzen.

Wenn Sie die RSX Kommandos |SPEAKSCREEN oder |SPEAKFILE benutzen bentigen Sie die 'blocking mode'.
Mit dem RSX Kommando |BLOCKON schalten Sie die 'blocking mode' ein.


Befehlsbersicht
================

Das RSX Kommando |LSHELP zeigt die Befehle an:

RSX Kommandos fuer LambdaSpeak:
|LSINIT / |LSINIC --> Diese Kommando initialisiert LambdaSpeak nach einem Reset
|RESET             |STOP             |SP,@text$      |LAMBDASPEAK,@text$
|SETVOLUME,0-15    |GETVOLUME,@v%    |SETVOICE,0-15  |GETVOICE,@v%
|SETSPEED,0-15     |GETSPEED,@v%     |SETDELAY,0-15  |GETDELAY,@v%
|SPEAKMODE         |GETLANGUAGE,@v%  |ENGLISH        |SPANISH
|LAMBDA            |SSA1             |DECTALK        |DKTRONICS
|SSASPO            |DKSPO            >Version:       >2018.08.15
|GETMODE,@v%       |GETVERSION,@v%   |BLOCKOFF       |BLOCKON
|CONFOFF           |CONFON           |GETFAST        |GETSLOW
|SPEAKINFO         |SPEAKSCREEN      |SPEAKFILE      |DAISY
|HAL9000           |AMDRUM           |PCMTEST
|PLAY,adr,len,del  |EPLAY,address,length/64,delay,E-RAM
|LSHELP --> will display this message. Support via PayPal: tfm@futureos.de


Befehle zur Kontrolle des LambdaSpeak:
--------------------------------------

|LSINIT: Initialisiert den LambdaSpeak bei Verwendung des LambdaSpeak ROMs. Im einzenlnen werden die Parameter-bergabe 
auf 'schnell' (mittels |GETFAST), die Sprache auf Englisch (|ENGLISH), die Blockierung auf aus (|BLOCKOFF), der 
Modus auf Epson (|LAMBDA) und die Sprechverzgerung auf minimal (20 ms) eingestellt (|SETDELAY,1).

|LSINIC: Initialisiert den LambdaSpeak bei Verwendung des LambdaSpeak ROMs. Im einzenlnen werden die Parameter-bergabe 
auf 'schnell' (mittels |GETFAST), die Sprache auf Spanisch (|SPANISH), die Blockierung auf aus (|BLOCKOFF), der 
Modus auf Epson (|LAMBDA) und die Sprechverzgerung auf minimal (20 ms) eingestellt (|SETDELAY,1).

|RESET: Entspricht in etwa dem Ein- und Ausschalten des LambdaSpeak. Setzt den LambdaSpeak in den dk'tronics Modus.

|STOP: Unterbricht die laufende Sprachausgabe (im Non-Blocking-Modus).


Befehle zur Auswahl des LambdaSpeak Modus:
------------------------------------------

|LAMBDA: Selektiert den kraftvollen Epson Modus.

|DECTALK: Selektiert den DECtalk Modus, hierbei ist sogar singen mglich.

|DKTRONICS: Schaltet auf den dk'tronics Modus um. Der LambdaSpeak reagiert nun wie der dk'tronics Spachsynthesizer.

|SSA1: Schaltet auf den Amstrad Modus um. Der LambdaSpeak reagiert nun wie der Amstrad SSA-1 Spachsynthesizer.

|SSASPO: Schaltet auf den SSA1 SPO256-AL2 Modus.

|DKSPO: Schaltet auf den dk'tronics SPO256-AL2 Modus.

|AMDRUM: Schaltet auf den Amdrum Modus um. Der LambdaSpeak reagiert nun wie das AMDRUM.
         Dieser Modus ist zu aktivieren, wenn die Befehle |PLAY und |EPLAY benutzt werden sollen.
         Achtung: KEINE Rckschaltung mglich. Der Amdrum Modus kann nur durch ein/ausschalten verlassen werden!


Befehle zum Einstellen der Parameter des LambdaSpeak
----------------------------------------------------

|SETVOLUME,0-15: Setzt die Lautstrke auf einen Wert von 1 bis 15. Der Wert 0 stellt den Standard ein.

|SETVOICE,0-15: Setzt die Stimme auf einen Wert von 1 bis 15. Der Wert 0 stellt den Standard ein.

|SETSPEED,0-15: Setzt die Sprechgeschwindigkeit auf einen Wert von 1 bis 15. Der Wert 0 stellt den Standard ein.

|SETDELAY,0-15: Setzt die Verzgerung auf einen Wert von 1 bis 15. Der Wert 0 stellt den Standard ein.
                Dabei ist die Zeit gemeint, die vergeht bis die an den LambdaSpeak geschickten Zeichen gesprochen werden

|ENGLISH: Schaltet die Sprachausgabe auf Englisch.

|SPANISH: Schaltet die Sprachausgabe auf Spanisch.

|BLOCKON und |BLOCKOFF: Damit wird das 'Blocking' aus und eingeschalten. Bei eingeschaltenem 'Blocking' hlt der
                        LambdaSpeak den CPC an bis alles Zeichen gesprochen wurden und der LambdaSpeak wieder bereit ist.

|CONFON und |CONFOFF: Schalten die 'Conformations' ein oder aus. Sind die Eingeschalten, so wird der LambdaSpeak
                      alle nderungen (z.B. Modus, Sprache etc.) akustisch quittieren.

|GETFAST und |GETSLOW: Beeinflussen die Reaktionsgeschwindigkeit des LambdaSpeak bei der Parameterbergabe.
                       Fr Maschinencode sollte man auf 'fast' schalten. Dies gilt auf fr diese RSX Erweiterung.
                       Fr BASIC Programme (z.B. wenn man OUT Befehle benutzt) sollte man auf 'slow' schalten.


Befehle zum Auslesen bzw. Einstellen der Parameter des LambdaSpeak
------------------------------------------------------------------

|GETVOLUME,@v%: Liest den Wert der 'Lautstrke' (1 bis 15) in eine Variable ein.
                Die verwendete Variable (hier: v%) muss vor Verwendung definiert werden.

|GETVOICE,@v%: Liest den Wert der 'Stimme' (1 bis 15) in eine Variable ein.
               Die verwendete Variable (hier: v%) muss vor Verwendung definiert werden.

|GETSPEED,@v%: Liest den Wert der 'Sprechgeschwindigkeit' (1 bis 15) in eine Variable ein.
               Die verwendete Variable (hier: v%) muss vor Verwendung definiert werden.

|GETDELAY,@v%: Liest den Wert der 'Verzgerung bis zum Sprechen' (1 bis 15) in eine Variable ein.
               Die verwendete Variable (hier: v%) muss vor Verwendung definiert werden.

|GETLANGUAGE,@v%: Liest den Wert der 'Sprache' (1 bis 15) in eine Variable ein.
                  Die verwendete Variable (hier: v%) muss vor Verwendung definiert werden.

|GETMODE,@v%: Liest den Wert des 'Sprach-Modus' (1 bis 15) in eine Variable ein. Hngt von Modus, Sprach und Blocking ab.
              Die verwendete Variable (hier: v%) muss vor Verwendung definiert werden.

|GETVERSION,@v%: Liest den Wert der Version des LambdaSpeak (1 bis 15) in eine Variable ein.
                 Die verwendete Variable (hier: v%) muss vor Verwendung definiert werden.

|SPEAKMODE: Der LambdaSpeak gibt seinen aktuellen Sprach-Modus an.


Befehle zur Sprachausgabe
-------------------------

|SP,@text$ oder |LAMBDASPEAK,@text$: Der in der Variable text$ enthaltene Text wird mittels des LambdaSpeak gesprochen.

|SPEAKSCREEN: Der aktuelle Bildschirminhalt wird mittels des LambdaSpeak gesprochen.
              ACHTUNG: Man muss hier zuvor mittels |BLOCKON das 'Blocking' eingeschalten haben.
              -------- Das Kommando kann durch lngeres drcken des ESCape Taste abgebrochen werden.

|SPEAKFILE,file$: Der Inhalt der ASCII Datei 'file$' wird mittels des LambdaSpeak gesprochen
                  ACHTUNG: Man sollte muss zuvor mittels |BLOCKON das 'Blocking' eingeschalten haben.
                  -------- Das Kommando kann durch lngeres drcken des ESCape Taste abgebrochen werden.


Spezielle Befehle
-----------------

|SPEAKINFO: Gibt Informationen ber den LambdaSpeak Synthesizer an.

|DAISY: Sing ein Lied.

|HAL9000: Zitiert den legendren HAL9000 Computer.

|PCMTEST: Schickt ein 'Beispiel-sample' an den Digital-Analog-Wandler der Amdrum Emulation. Endlosschleife.


Befehle zum Amdrum Modus des LambdaSpeak
----------------------------------------

|PLAY,adr,len,del: Spielt ein Sample via Amdrum Emulation. Das Sample beginnt an Adresse 'adr' im Speicher,
                   es ist 'len' Bytes lang und wird mit der Verzgerung von 'del' abgespielt.
                   Achtung: Fr diesen Befehl muss zuvor mit dem Befehl |AMDRUM auf den AMDRUM
                   -------- Modus umgeschalten werden. Es kann nicht zurckgeschalten werden.

|EPLAY,adr,len/64,delay,E-RAM: Spielt ein Sample via Amdrum Emulation. Das Sample beginnt ab Adresse 'adr'
                               im Speicher. Es ist 'len/64' Bytes lang. Die Lnge in Bytes ist also: len * 64
                               Dadurch lassen sich Samples bis zu 4096 KB abspielen.
                               Das Erweiterungs-RAM in dem das Sample beginnt wird mittels 'E-RAM' bergeben.
                               Der Parameter E-RAM hat das Fomat &7FC4, &7FC5, ... &7FFF.
                               Achtung: Fr diesen Befehl muss zuvor mit dem Befehl |AMDRUM auf den AMDRUM
                               -------- Modus umgeschalten werden. Es kann nicht zurckgeschalten werden.

ACHTUNG: Samples im Hauptspeicher werden mittels |PLAY abgespielt und Samples im Erweiterungs-RAM mittels |EPLAY



Updates / Version 1.02
----------------------
2018.08.15: Loadable RSX from disc updated. English manual added.
2018.07.27: RSX |LS replaced by RSX |SP (because there is also the RSX |LS in the M4 ROM)
2018.06.28: RSX commands |SSASPO and |DKSPO enhanced
2018.05.27: Added RSX commands |SSASPO and |DKSPO to enter SPO256-AL2 modes
2018.04.30: Added ESCape feature to |SPEAKSCREEN and |SPEAKFILE
2018.04.27: German Manual added (well, started doing that ;-))
2018.04.21: Added RSX command |SPEAKFILE to speak the content of an ASCII/FSCW file
2018.04.17: Added RSX command |LSINIT to initialize LambdaSpeak after power on or reset
2018.04.09: LS-ROM: RSX command |LSHELP added, to display command summary; sign-on message added; checksum added
2018.03.29: Expansion ROM "LS.ROM" added
2018.03.28: First release of version 1.0



Greets,
TFM of FutureSoft




























Stop scrolling... nothing will show up...













































Now you know it better ;-)













This software is powered by FutureSoft and lots of CPC spirit, also some 6128 Plus spirit ;-)













